GetWindowProperty

PATHMac OS 8 and 9 Developer Documentation > Human Interface Toolbox > Window Manager >

Programming With the Mac OS 8.5 Window Manager

GetWindowProperty

Obtains a piece of data that is associated with a window.



 
pascal OSStatus GetWindowProperty (

                     WindowPtr window,

                     PropertyCreator propertyCreator,

                     PropertyTag propertyTag,

                     UInt32 bufferSize,

                     UInt32 *actualSize,

                     void *propertyBuffer);

window: A value of type WindowPtr . Pass a pointer to the window to be examined for associated data.
propertyCreator: A four-character code. Pass the creator code (typically, the application's signature) of the associated data to be obtained.
propertyTag: A four-character code. Pass the application-defined code identifying the associated data to be obtained.
bufferSize: Pass a value specifying the size of the associated data to be obtained. If the size of the data is unknown, use the function GetWindowPropertySize to get the data's size. If the size specified does not match the actual size of the property, GetWindowProperty only retrieves data up to the size specified or up to the actual size of the property, whichever is smaller, and an error is returned.
actualSize: A pointer to a value. On return, the value specifies the actual size of the obtained data. You may pass NULL for the actualSize parameter if you are not interested in this information.
propertyBuffer: A pointer to a buffer. On return, this buffer contains a copy of the data that is associated with the specified window.
function result: A result code. See Result Codes.

DISCUSSION

The data retrieved by the GetWindowProperty function must have been previously associated with the window with the function SetWindowProperty .

VERSION NOTES

Available with Mac OS 8.5 and later.